MCP 문서 관리

메뉴

홈
문서 목록
관리자 로그인

문서 정보

최종 수정일:
2025-05-13 10:38
태그:
#MCP #써드파티 #프롬프트관리 #LLMOps

Langfuse 프롬프트 관리 MCP 서버

Langfuse 프롬프트 관리 MCP 서버

Langfuse 프롬프트 관리 MCP 서버는 Langfuse 프롬프트 관리 시스템과 통합되는 Model Context Protocol(MCP) 서버입니다. 이 서버를 통해 AI 어시스턴트가 Langfuse에 저장된 프롬프트를 발견하고 검색하며 활용할 수 있습니다.

특징

  • 프롬프트 발견: 사용 가능한 프롬프트 목록을 조회합니다.
  • 프롬프트 검색: 특정 프롬프트를 이름으로 검색합니다.
  • 프롬프트 변수 지원: 프롬프트에서 필요한 변수와 인자를 처리합니다.
  • MCP 프롬프트 명세 구현: MCP 프롬프트 발견 및 검색 명세를 구현합니다.
  • 도구 호환성: 프롬프트 기능을 지원하지 않는 MCP 클라이언트를 위한 도구도 제공합니다.
  • 버전 관리: Langfuse의 프롬프트 버전 관리 기능을 활용합니다.
  • 협업 지원: 팀 전체에서 관리되는 프롬프트에 접근할 수 있습니다.

API

리소스

Langfuse MCP 서버는 주로 프롬프트 관련 리소스를 제공합니다:

  • Prompts: Langfuse에 저장된 프롬프트 템플릿

도구

Langfuse MCP 서버는 프롬프트 관리를 위한 다음 도구를 제공합니다:

listPrompts

사용 가능한 프롬프트 목록을 조회합니다. - 입력: - cursor: (선택 사항) 페이지네이션 커서 - limit: (선택 사항) 반환할 최대 프롬프트 수

getPrompt

특정 프롬프트의 내용과 메타데이터를 가져옵니다. - 입력: - name: 가져올 프롬프트의 이름

compilePrompt

프롬프트를 컴파일하고 변수를 적용합니다. - 입력: - name: 프롬프트 이름 - variables: 프롬프트에 적용할 변수 맵

사용 방법

Langfuse MCP 서버를 사용하려면 다음 단계를 따르세요:

  1. Langfuse 계정 설정:
  2. Langfuse에 계정을 만듭니다.
  3. 프롬프트를 작성하고 관리합니다.

  4. API 키(공개 키와 비밀 키)를 생성합니다.

  5. MCP 서버 설치 및 구성: 

    # 저장소 클론
git clone https://github.com/langfuse/mcp-server-langfuse
cd mcp-server-langfuse
# 의존성 설치
npm install
# 빌드
npm run build

  6. Claude Desktop 또는 다른 MCP 클라이언트 구성: 

    {
  "mcpServers": {
    "langfuse": {
      "command": "node",
      "args": ["<절대경로>/build/index.js"],
      "env": {
        "LANGFUSE_PUBLIC_KEY": "your-public-key",
        "LANGFUSE_SECRET_KEY": "your-secret-key",
        "LANGFUSE_BASEURL": "https://cloud.langfuse.com"
      }
    }
  }
}

  7. 환경 변수를 직접 설정하여 실행할 수도 있습니다: 

    LANGFUSE_PUBLIC_KEY="your-public-key" LANGFUSE_SECRET_KEY="your-secret-key" LANGFUSE_BASEURL="https://cloud.langfuse.com" node <절대경로>/build/index.js

환경 변수

  • LANGFUSE_PUBLIC_KEY (필수): Langfuse 공개 API 키
  • LANGFUSE_SECRET_KEY (필수): Langfuse 비밀 API 키
  • LANGFUSE_BASEURL (선택 사항): Langfuse API 기본 URL (기본값: "https://cloud.langfuse.com")

현재 제한 사항

Langfuse MCP 서버는 계속 개발 중이며 다음과 같은 제한 사항이 있습니다:

  1. 프로덕션 레이블 전용: 현재는 Langfuse에서 '프로덕션' 레이블이 지정된 프롬프트만 반환됩니다.
  2. 선택적 인자 가정: 모든 인자는 선택 사항으로 간주되며, Langfuse에서는 변수에 대한 명세가 없기 때문에 설명이 포함되지 않습니다.
  3. 목록 작업 비효율성: 목록 작업에서는 인자를 추출하기 위해 각 프롬프트를 개별적으로 가져와야 합니다. 이 방식은 작동하지만 효율적이지 않습니다.

사용 사례

Langfuse MCP 서버는 다음과 같은 상황에서 특히 유용합니다:

  1. 프롬프트 중앙화: 조직 전체에서 사용되는 LLM 프롬프트를 중앙에서 관리하고 액세스합니다.
  2. 품질 관리: 프롬프트의 버전 관리 및 릴리스를 통해 일관된 품질을 유지합니다.
  3. 협업 개선: 팀원들이 함께 프롬프트를 편집하고 평가하며 릴리스할 수 있는 협업 워크플로우를 구축합니다.
  4. LLMOps 최적화: 프롬프트 관리를 LLMOps 파이프라인에 통합하여 AI 애플리케이션 개발을 간소화합니다.

연결된 구성 요소

참고 자료